Load Image from File

Prior to loading an image, set the load options to provide specific instructions for loading the image. If no load options are specified, ImagXpress® uses default values when loading the image.

Load from a Disk File

To load an image from a file, set the FileName property to the path and filename you want to load. ImagXpress looks at the file extension to recognize the file type. If the FileName property is set to a valid filename, ImagXpress opens the file, reads the header information, and loads the image. When an image is loaded from file, it is stored as a DIB. This DIB, with the image's palette information, tag information and color profile information are stored in the target ImagXpress buffer (identified by the ProcessImageID property). The ViewImageID is set to the newly loaded image, enabling the display of the new image.

Check the check the ImageStatus method to understand the current loading status of the image.

Load from an HTTP or FTP Location

ImagXpress loads files from FTP and HTTP asynchronously. The image will not have been loaded immediately after setting the FileName property. The user should either rely on the ImageStatus event or the Progress event to determine when an FTP or HTTP file has been loaded and another operation can be performed on the image.

Set the FTPUserName and FTPPassword properties. You might need to set the FTPMode and ProxyServer properties as well, depending on your server configuration.
Set the FileName property to the full path.

If the file is extremely large and heavily compressed, such as a JPEG image and the computer was slow, then it could take more than a few seconds to decode the image and display it. To let the user know that the computer is working and not locked up, set the ViewProgressive property to True. With ViewProgressive active, the image displays incrementally, as it decodes, instead of waiting until the control finishes loading it. ViewProgressive is useful when loading large images over the Internet.

Load a Multi-page Image

ImagXpress supports the following multi-page image formats: TIFF, ICO, and DCX. Multi-page images can be read (decompressed and loaded) in the Professional edition. The standard edition can read (decompress and load) the first page of a multi-page image.

To decompress and load a multi page image from file, you must first set the PageNbr property to the page you want to load and then set the FileName property to load. You can use the NumPages method to find out how many pages in a file.

Colorspace Conversions

CMYK Conversion - If a CMYK Tiff image file is loaded into ImagXpress, it is automatically converted to RGB. The application can use the ICM properties and methods to control the CMYK conversion process.